home *** CD-ROM | disk | FTP | other *** search
/ Aminet 44 / Aminet 44 (2001)(GTI - Schatztruhe)[!][Aug 2001].iso / Aminet / mus / play / mhimdev.readme < prev    next >
Text File  |  2001-07-04  |  4KB  |  118 lines
  1. Short:  MHI driver for mpeg.device
  2. Author: Smack/Infect! (Michael Henke)
  3. Type:   mus/play
  4.  
  5. $VER: mhimdev.library 1.1 (Sun 03-Jun-2001)
  6.  
  7.  
  8.  
  9.  #features
  10.    mhimdev.library is a driver for the MHI system. It doesn't support any
  11.    specific MPEG audio hardware decoder directly, instead it sends the data
  12.    to an mpeg.device driver. It's an "interface converter" or "wrapper" that
  13.    allows you to use your existing MPEG hardware and drivers in applications
  14.    which support the new MHI interface only. (such as AmigaAMP)
  15.  
  16.    This program is free software, full source code included.
  17.  
  18.  
  19.  
  20.  #requirements
  21.    -AmigaOS V37+
  22.    -MPEG audio hardware decoder with mpeg.device support
  23.     (eg. CD32 FMV, Delfina DSP, MAS Player, Melody and possibly some more)
  24.  
  25.    -developed on A1200 - OS3.1/68030+882@40MHz/16MBFastRAM/Delfina1200DSP
  26.    -tested with delfinampeg.device 1.2 and AmigaAMP 2.9-beta1
  27.  
  28.  
  29.  
  30.  #changes since previous release
  31.    -minor code polishing / optimizing
  32.    -added backup email address (Strato sucks!)
  33.  
  34.  
  35.  
  36.  #how to use
  37.    1) install library
  38.         > makedir LIBS:MHI
  39.         > copy mhimdev.library LIBS:MHI/
  40.  
  41.    2) configure library
  42.       two parameters must be set in the environment variable MHIMDEV
  43.         -name of your specific mpeg.device
  44.         -unit number (usually 0, but may be different for your hardware)
  45.       example from my system:
  46.         > setenv MHIMDEV delfinampeg.device 0
  47.         > copy ENV:MHIMDEV ENVARC:
  48.  
  49.    3) configure application(s)
  50.       at the moment only AmigaAMP uses the new MHI interface.
  51.         -start AmigaAMP prefs program
  52.         -go to System page
  53.         -select engine: MHI-Driver
  54.         -select driver: LIBS:MHI/mhimdev.library
  55.  
  56.    4) have fun. ;-)
  57.  
  58.  
  59.  
  60.  #known problems
  61.    -MHI defines a few extensions that are NOT SUPPORTED by the mpeg.device
  62.     standard so they are simply ignored. Currently they are:
  63.       -tone control (bass/mid/treble)
  64.       -crossmixing control (stereo channel separation)
  65.  
  66.    -mhimdev.library was written according to the mpeg.device specification so
  67.     it should work with all MPEG decoders which support this interface.
  68.     Due to lack of other hardware decoders I can test it only with my Delfina
  69.     using delfinampeg.device. I would like to know what other mpeg.devices are
  70.     used with this MHI driver. (please report successful usage, too)
  71.  
  72.  
  73.  
  74.  #acknowledgements
  75.    mhimdev.library uses ideas/code from:
  76.    -MHI developers package by Paul Qureshi and Thomas Wenzel
  77.    -Melody developers package by Thorsten Hansen
  78.    -CLib-SDI example.library by Dirk Stoecker, Andreas R. Kleinert and others
  79.  
  80.  
  81.  
  82.  #author
  83.    mailto: smack42@web.de  or  smack@smack.de
  84.  
  85.    mhimdev.library - MHI driver for mpeg.device
  86.    Copyright (C) 2001  Michael Henke
  87.  
  88.    This program is free software; you can redistribute it and/or modify
  89.    it under the terms of the GNU General Public License as published by
  90.    the Free Software Foundation; either version 2 of the License, or
  91.    (at your option) any later version.
  92.  
  93.    This program is distributed in the hope that it will be useful,
  94.    but WITHOUT ANY WARRANTY; without even the implied warranty of
  95.    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  96.    GNU General Public License for more details.
  97.  
  98.    You should have received a copy of the GNU General Public License
  99.    along with this program; if not, write to the Free Software
  100.    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  101.  
  102.  
  103. ============================= Archive contents =============================
  104.  
  105. Original  Packed Ratio    Date     Time    Name
  106. -------- ------- ----- --------- --------  -------------
  107.    18113    7000 61.3% 03-Jun-01 22:11:12 +COPYING
  108.     2428    1606 33.8% 03-Jun-01 22:11:12 +mhimdev.library
  109.     3427    1690 50.6% 03-Jun-01 22:11:12 +README
  110.      180     143 20.5% 03-Jun-01 22:11:12 +CHANGES
  111.     4239    1520 64.1% 03-Jun-01 22:11:12 +library.c
  112.    11166    3096 72.2% 03-Jun-01 22:11:12 +mhimdev.c
  113.     2358    1010 57.1% 03-Jun-01 22:11:12 +mhimdev.h
  114.      129     101 21.7% 03-Jun-01 22:11:12 +SCOPTIONS
  115.      183      82 55.1% 03-Jun-01 22:11:12 +smakefile
  116. -------- ------- ----- --------- --------
  117.    42223   16248 61.5% 04-Jun-101 19:22:54   9 files
  118.